MLBB API Web v4.0.8
MLBB Card Install OpenMLBB Tutorial GitHub Stars
Home User MLBB Academy Addon

Web Playground

Academy Endpoint

Interactive request form for this API endpoint.

Each card below maps directly to an API endpoint. Query, path, and request body fields are generated from OpenAPI.

Jump to endpoint

GET /web/academy/meta/version GET /web/academy/heroes/catalog GET /web/academy/roles GET /web/academy/equipment GET /web/academy/equipment/expanded GET /web/academy/spells GET /web/academy/emblems GET /web/academy/ranks GET /web/academy/ranks/{rank_id} GET /web/academy/recommended GET /web/academy/recommended/{recommended_id} GET /web/academy/heroes GET /web/academy/heroes/{hero_identifier}/stats GET /web/academy/heroes/{hero_identifier}/lane GET /web/academy/heroes/{hero_identifier}/win-rate/timeline GET /web/academy/heroes/{hero_identifier}/builds GET /web/academy/heroes/{hero_identifier}/counters GET /web/academy/heroes/{hero_identifier}/teammates GET /web/academy/heroes/{hero_identifier}/trends GET /web/academy/heroes/{hero_identifier}/recommended GET /web/academy/heroes/ratings GET /web/academy/heroes/ratings/{subject}

GET Hero Recommended Builds

/web/academy/heroes/{hero_identifier}/builds

Open Only This

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • lane: Lane. Allowed values: exp, mid, roam, jungle, gold. from /api/academy/heroes/{hero_identifier}/lane
  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero build data:

  • records: Array of build entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • heroid: Hero ID.
          • hero_name: Hero name.
          • real_road: Lane assignment ID.
          • build: Array of recommended builds, each containing:
              • equipid: List of equipment IDs.
              • emblem: Emblem configuration:
                  • emblemid: Emblem ID.
                  • emblemname: Emblem name.
                  • emblemattr: Emblem attributes (e.g., '+10% Spell Vamp').
                  • attriicon: Emblem attribute icon URL.
              • battleskill: Battle spell configuration:
                  • battleskillid: Battle spell ID.
                  • skillname: Spell name (e.g., 'Retribution').
                  • skillshortdesc: Short description.
                  • skilldesc: Full description of spell effects.
                  • skillicon: Spell icon URL.
              • runeid: Rune ID.
              • new_rune_skill: Array of rune skill IDs.
              • build_pick_rate: Pick rate of the build.
              • build_win_rate: Win rate of the build.

This endpoint is useful for:

  • Displaying historical or community-recommended builds.
  • Providing backward compatibility for older integrations.
  • Should be replaced with newer endpoints for up-to-date build recommendations.
hero_identifier path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Required.

lane query
▾

Filter heroes by lane (/api/academy/heroes/{hero_identifier}/lane). Required.

rank query
▾

Rank filter for hero statistics.

size query

Number of items per page. Minimum: 1.

index query

Page index for pagination. Minimum: 1.

lang query
▾

Language code for localized content.

GET /api/academy/heroes/{hero_identifier}/builds